aliases:
  - Obsidian Publish/Publish and unpublish notes
description: Learn how to publish your content using Obsidian Publish
permalink: publish/publish
mobile: true
publish: true

Publish your content

This page explains how to manage your published content. To learn how to customize your site's styling, see Customize your site.

Prerequisites

An Obsidian account. If you don't have one, sign up now.
An active Obsidian Publish subscription. If you don't have one, subscribe from your account dashboard.
The Publish core plugin is enabled.
A Publish site is created.

Publish notes

In Ribbon, select Publish changes ().
In the Publish changes dialog, select NEW to view all unpublished notes.
Select the notes you want to publish.
Select Publish.

Unpublish notes

Notes remain in your local vault even after you unpublish them.

In Ribbon, select Publish changes ().
In the Publish changes dialog, select UNCHANGED to view all published notes.
Select the notes you want to unpublish.
Select Publish.

Update a published note

In Ribbon, select Publish changes ().
In the Publish changes dialog, select CHANGED to view all modified notes since the last publish.
Select the notes you want to update.
Select Publish.

Deleting renamed or removed notes and images from Publish happens in this step. You must manually select the checkbox to delete this data, as it is not automatically selected for safety.

Publish linked data

When publishing notes containing links to other notes or embedded images, broken links may occur unless the linked notes are also published. Obsidian Publish helps prevent this by automatically selecting media linked from the notes you’ve already chosen.

To include all linked notes, select Add linked in the Publish changes dialog.

Before publishing, review the updated selection to ensure it doesn’t include any data you’re not ready to publish.

The Add linked function respects any exclusions defined in Ignore data.

Automatically select data to publish

Set publish: true in the Properties of a note to automatically include it for publishing as either a new or changed note.

You can also automatically select notes and linked images in specific folders by adding them as Included folders:

In Ribbon, select Publish changes () or open the Command palette and type Publish: Publish changes....
Select the Manage publish filters () icon.
In the Included folders section, select Manage.
Choose the folders you want to include from the suggester.
The folder is added to the included list.
Select Done when finished.

Ignore data

To ignore a note in Obsidian Publish, set publish: false in the Properties of the note. The note no longer appears in the list of notes to publish.

You can also auto-ignore notes and images in specific folders by adding them as Excluded folders:

In Ribbon, select Publish changes () or open the Command palette and type Publish: Publish changes....
Select the Manage publish filters () icon.
In the Excluded folders section, select Manage.
Choose the folders you want to exclude from the suggester.
The folder is added to the excluded list.
Select Done when finished.